home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 12 / CU Amiga Magazine's Super CD-ROM 12 (1997)(EMAP Images)(GB)[!][issue 1997-07].iso / CUCD / Graphics / xanim / doc / _creative.readme < prev    next >
Text File  |  1997-01-26  |  11KB  |  290 lines
  1.  
  2. FILE: creative.readme
  3. DATE: 16Oct96
  4. AUTH: Mark Podlipec
  5.  
  6. /* Creative CYUV Decompression Module for XAnim
  7.  *
  8.  * Revision History
  9.  *----------------------
  10.  *  Rev 0.0 31May96  Podlipec (podlipec@BayNetworks.com)
  11.  *             Wrote the Code from Spec.
  12.  *  Rev 1.0 04Jun96  Podlipec (podlipec@BayNetworks.com)
  13.  *                   Initial release. For use with XAnim 2.70.6 or higher.
  14.  */
  15.  
  16. -------------------------------------------------------------------------------
  17.               Copyright and Licensing Notice
  18.  
  19.   The CYUV Video Codec is Copyrighted by Creative Technology Ltd, 1994-1996.
  20.   All rights reserved.
  21.  
  22.   By Using this Software, you are agreeing to be bound by the terms of
  23.   this agreement. Do not use this software until you have carefully
  24.   read and agreed to the following terms and conditions. If you do
  25.   not agree to the terms of this agreement, then remove all copies.
  26.  
  27.   Restrictions:
  28.  
  29.   You MAY:
  30.       1: Freely use this Software in conjunction with XAnim.
  31.  
  32.   You MAY NOT:
  33.       1: Use this Software for any application other than XAnim.
  34.       2: Sell or distribute this Software without direct written
  35.          permission from the Author.
  36.       3: Sublicense this Software.
  37.       4: Reverse engineer, decompile, or disassemble this Software.
  38.  
  39.   WARRANTY: This Software is provided "AS IS". There are no warranties
  40.   of any kind either express or implied including warranties of
  41.   merchantability or fitness for any particular purpose.
  42.  
  43.   LIMITATION OF LIABILITY: Neither Creative Technology nor the Author 
  44.   shall be liable for any loss of profits, loss of use, mood swings,
  45.   loss of data, interruptions of business, nor for indirect, special, 
  46.   incidental or consequential damages of any kind whether under this 
  47.   agreement or otherwise, even if advised of the possibility of such 
  48.   damages.
  49.   
  50.   Definitions:
  51.      Software: XAnim CYUV decompression modules precompiled for various
  52.                machine platforms and OS. 
  53.      Author:   Mark Podlipec (podlipec@BayNetworks.com)
  54.  
  55. -------------------------------------------------------------------------------
  56.  
  57.   XAnim is owned and copyrighted by Mark Podlipec.
  58.   Copyright (C) 1990,1991,1992,1993,1994,1995,1996 Mark Podlipec.
  59.   All rights reserved.
  60.  
  61.   podlipec@BayNetworks.com
  62.   http://xanim.va.pubnix.com/home.html
  63.   http://smurfland.cit.buffalo.edu/xanim/home.html
  64.  
  65. -------------------------------------------------------------------------------
  66.  
  67. NOTE: XAnim 2.70.6 OR GREATER IS REQUIRED FOR Creative CYUV SUPPORT!!!
  68.  
  69. These modules will add AVI support for the following Video Codecs:
  70.  
  71.             + Creative CYUV     (CYUV)      depth 16
  72.  
  73. CYUV support for XAnim is being provided as an optional machine
  74. specific object module that is linked into XAnim at compile time.
  75.  
  76.  1) The first step is figuring out which XAnim CYUV decompression
  77.     library module you need to obtain for your machine.
  78.  
  79.     Below is a table that matches your machine/OS to which library
  80.     you need to download(ok, they're really object files). 
  81.  
  82.       Machine/OS                        Library Name(LIB_NAME)  Size(bytes)
  83.     ------------                        ----------------------------------
  84.      Sun 3's(SunOS 4.x)            xa1.0_cyuv_sun3.o     1231  
  85.     cross-compiler provided to me
  86.     by Sebastien C. Roy (Sebastien.Roy@unh.edu)
  87.     ------------                        ----------------------------------
  88.      Sun Sparcs(SunOS 4.x)        xa1.0_cyuv_sparcAOUT.o   1408 
  89.     ------------                        ----------------------------------
  90.      Sun Sparcs(SunOS 5.x)        xa1.0_cyuv_sparcELF.o    1936
  91.      Sun Sparcs(Solaris  )        xa1.0_cyuv_sparcELF.o    1936
  92.     ------------                        ----------------------------------
  93.      Sun x86(Solaris)            xa1.0_cyuv_sol86.o       1988
  94.          cross-compiler provided to me
  95.          by Daniel Rock (rock@wurzelausix.CS.Uni-SB.DE)
  96.     ------------                        ----------------------------------
  97.      HP 9000/7xx                    xa1.0_cyuv_parisc.o      1952 
  98.     ------------                        ----------------------------------
  99.      HP 68k                         xa1.0_cyuv_68k.o     1263 
  100.     cross-compiler provided to me
  101.     by Stan Brown
  102.     ------------                        ----------------------------------
  103.      DEC Alpha OSF/1            xa1.0_cyuv_alphaOSF1.o   3536 
  104.     ------------                        ----------------------------------
  105.      x86 Esix 4.03a            xa1.0_cyuv_sol86.o       1988
  106.      x86 Unixware 2.1            xa1.0_cyuv_sol86.o       1988
  107.     ------------                        ----------------------------------
  108.      x86 386/NetBSD            xa1.0_cyuv_netbsd386.o   1275
  109.     cross-compiler provided to me
  110.     by Roland C Dowdeswell(roland@imrryr.org)
  111.     ------------                        ----------------------------------
  112.      x86 BSDI 2             xa1.0_cyuv_netbsd386.o   1275
  113.     ------------                        ----------------------------------
  114.      x86 FreeBSD 2.1.0            xa1.0_cyuv_netbsd386.o   1275
  115.     ------------                        ----------------------------------
  116.      x86 Linux AOUT               xa1.0_cyuv_linuxAOUT.o   1351
  117.      x86 Linux ELF            xa1.0_cyuv_linuxELF.o    2072
  118.     both cross-compilers provided to me 
  119.     by Mark Nordberg(mark@catt.ncsu.edu) 
  120.     ------------                        ----------------------------------
  121.      PowerPC Linux                xa1.0_cyuv_linuxPPC.o    2256
  122.     cross-compiler provided to me
  123.     by Tom Rini
  124.     ------------                        ----------------------------------
  125.      SGI Irix 5.x and 6.x        xa1.0_cyuv_sgi.o         3764
  126.     cross-compiler provided to me 
  127.     by Paul Close
  128.     ------------                        ----------------------------------
  129.      Pyramid Nile DC/OSx d087        xa1.0_cyuv_sgi.o         3764
  130.         There are some warnings that you can ignore.
  131.         Might also work with MIS series DC/OSx c087.
  132.     ------------                        ----------------------------------
  133.  
  134.     yeah, I know it's a short list, but these are the only machines
  135.     that I have physical access to or cross-compilers for.
  136.  
  137.     NOTE: SunOS 4.1.3 uses AOUT and Sun Solaris used ELF. They're not
  138.     compatible.
  139.  
  140.     NOTE: If your machine is not supported, it's because I don't have physical
  141.     access to that type of machine. There are a handful of options
  142.     available to you(not all of them may be feasible)
  143.  
  144.         a) Permanently loan me that type of machine so that I may
  145.            compile a library module for that machine type. Please
  146.            contact me first and yes, I'd be surprised if someone
  147.            chose this option. :^) 
  148.  
  149.         b) Send me a cross-compiler for your machine type. Must
  150.            be a Sparc SunOS 4.1.x executable or more specifically
  151.            it must run on my machine.  I'll do the compile and then
  152.            you'll need to verify that the resulting library module
  153.            works on your machine.
  154.  
  155.        Yes, I know gcc can be a cross-compiler. No, I don't currently
  156.        have the time to setup it up for all the various platforms.
  157.            
  158.      Since I'm not allowed to distribute the source code I can't login
  159.      to an account on a remote machine in order to do the compile.
  160.  
  161.      Also, I personally can't give you a non-disclosure. You need
  162.      to contact Creative about licensing CYUV.
  163.  
  164.  2) Obtaining the object files. Follow the steps below:
  165.  
  166.         EITHER
  167.  
  168.         1) Download the modules from one of the XAnim Web Pages
  169.  
  170.                 http://xanim.va.pubnix.com/home.html
  171.                 http://smurfland.cit.buffalo.edu/xanim/home.html
  172.  
  173.         OR
  174.  
  175.     1) cd into the XAnim directory on your machine
  176.     2) ftp xanim.va.pubnix.com     OR  ftp 199.170.0.28
  177.     3) user is "anonymous"
  178.     4) passwd is your email address
  179.     5) "type binary"            VERY IMPORTANT
  180.     6) "cd modules"
  181.     7) "get LIB_NAME.Z"            NOTE: the .Z at the end
  182.     8) "quit"
  183.  
  184.     NOTE: LIB_NAME is obtained from the table in section 1 based
  185.      on the type of machine and OS you are running. If you don't
  186.      know, contact your system administrator or a coworker who
  187.      does know. 
  188.  
  189.  3) "uncompress LIB_NAME.Z"
  190.  
  191.      This will create LIB_NAME from LIB_NAME.Z
  192.  
  193.  3a) NOTE: if you want to prevent "make clean" from removing this
  194.      file you should do the following:
  195.  
  196.      "chmod -w LIB_NAME"
  197.  
  198.      Do a "man chmod" for more info on this unix command.
  199.  
  200.  4) Edit Section III of either your Imakefile or Makefile(derived
  201.     from Makefile.unx).  If you are not sure which one to
  202.     use then read the compile.help that came with xanim.
  203.       
  204.     a) In Section III of either the Imakefile or Makefile
  205.  
  206.        Uncomment out the following define:
  207.  
  208.          XA_CYUV_DEF = -DXA_CYUV
  209.  
  210.       and add LIB_NAME to the XA_CYUV_LIB define. For example
  211.       if you have Sun Sparc running SunOS 4.1.3 then you would
  212.       use the following:
  213.  
  214.         XA_CYUV_LIB = xa1.0_cyuv_sparcCOFF.o
  215.  
  216.       For other machine/OS types, use the approriate xa1.0_cyuv_*.o file
  217.       listed in the table at the top of this readme.
  218.  
  219.       NOTE:  There is no "-" or anything other prefix. Just the object 
  220.              file name.
  221.  
  222.     b) If and ONLY if you are using the Imakefile(in other
  223.        words DON'T do this if you are using the Makefile(derived
  224.        from Makefile.unx)) then do the following:
  225.  
  226.       "xmkmf" 
  227.    
  228.     c) Now(regardless of which makefile)
  229.  
  230.       "touch xanim.h" 
  231.       "make xanim"
  232.  
  233.       NOTE: make sure you see -DXA_CYUV on the compile command lines
  234.       and make sure both xa_avi.c and xa_qt.c get recompiled.
  235.  
  236.     d) You should use "make xaclean" instead of "make clean" if you
  237.        want to preserve the decompression modules.
  238.    
  239.  5)  Have fun. :^)
  240.  
  241. -------------------------------------------------------------------------
  242. NOTES on how XAnim options affect CYUV on 8 bit Color displays/visuals.
  243.  
  244. None of these options matter on monochrome/TrueColor/DirectColor displays
  245. and visuals.
  246.  
  247.   With no options, XAnim will create a 256 entry RGB332 colormap
  248.   and dither to that. 
  249.  
  250.      xanim  free_fall.avi
  251.  
  252.   -F will turn off this dithering and XAnim will instead truncate
  253.   the 24bit RGB values down to the RGB332 colormap.(I see no real
  254.   advantage to this, which is why +F is on by default)
  255.  
  256.      xanim  -F free_fall.avi
  257.  
  258.   The +CF4 option will TURN OFF the dithering by default. +CF4 causes
  259.    XAnim to scan the animation ahead of time and the select the
  260.    "best" 256 colors from the possible thousands sampled. These colors
  261.    may be further reduced depending on how many colors are still 
  262.    available(ie not in use by other X11 applications).
  263.  
  264.      xanim +CF4 free_fall.avi
  265.  
  266.   If you specify +F AFTER the +CF4 option, dithering will be used
  267.   with the +CF4 option.
  268.  
  269.      xanim +CF4 +F free_fall.avi
  270.  
  271.  
  272.   The -Cn option may be used with all of the above examples. -Cn tells
  273.    XAnim to create it's own colormap, giving it FULL USE of those
  274.    256 colors. Please note that it is up to your X11 Window Manager(NOT
  275.    XAnim) to install this colormap based on which window the Color Focus
  276.    is on. Normally, Color Focus follows the mouse pointer, but not
  277.    always.
  278.  
  279.  
  280.       xanim -Cn free_fall.avi
  281.  
  282.       xanim -Cn +CF4 free_fall.avi
  283.  
  284.  
  285.  
  286. Mark Podlipec
  287. podlipec@BayNetworks.com
  288.  
  289.  
  290.